home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 32 / cwp.zip / XWP.DOC < prev    next >
Text File  |  1990-10-27  |  15KB  |  384 lines
  1. XWP.DOC
  2.  
  3. Copyright (c) 1990 Longridge Software. All rights reserved.
  4.  
  5. INTRODUCTION
  6.  
  7. The purpose of this file is to explain the licensing agreement covering the
  8. program Crossword Publisher (XWP) (tm), and to outline how to use the program.
  9.  
  10. Crossword Publisher is a program for MS-DOS computers including the IBM PC, XT,
  11. AT, and PS/2 families and compatibles.
  12. Crossword Publisher is a crossword pre-press utility:
  13. it takes a definition of a crossword puzzle contained in a
  14. data file and generates text files using a setup file.
  15. These text files can then be used with popular desktop publishing programs to
  16. create a publication quality crossword.
  17.  
  18. Crossword Publisher automatically generates clue numbers, checks word placement,
  19. reports phantom words resulting from the juxtaposition of two words in the
  20. crossword matrix, generates either a single file containing the clues and the
  21. crossword matrix or two files, one containing the clues and one the matrix.
  22.  
  23. Crossword Publisher not only allows you to create professional looking crosswords
  24. for your newsletter or magazine, it also allows you to incorporate changes
  25. and rapidly generate new artwork.
  26.  
  27. Crossword Publisher was written by Richard L. Siddall and is published
  28. by Longridge Software.
  29.  
  30. ABOUT THIS DOCUMENT
  31.  
  32. This file has a very simple format.
  33. By leaving out justification and other textual effects, we hope that formatting
  34. the document for printing will be easier for you.
  35.  
  36. TRADEMARKS
  37.  
  38. MS-DOS is a trademark of Microsoft Corporation.
  39.  
  40. IBM is a trademark of International Business Machine Corporation.
  41.  
  42. The name Crossword Publisher is a trademark of Richard L. Siddall.
  43.  
  44. DISCLAIMER
  45.  
  46. Use of this program acknowledges this disclaimer of warranty by the user:
  47.  
  48. Crossword Publisher is supplied "as is."
  49. Longridge Software disclaims all warranties, express or implied, including,
  50. without limitation, the warranties of merchantability and of fitness of this
  51. product for any purpose.
  52. Longridge Software assumes no liability whatsoever for any and all damages
  53. which may or may not result from the use of this product.
  54.  
  55. Use of Crossword Publisher is at your own risk.
  56. This product is designed to create output data files.
  57. This can result in the overwriting of existing files.
  58. Use may result in permanent loss of data.
  59.  
  60. Longridge Software is not affiliated with any other company.
  61.  
  62. SHAREWARE
  63.  
  64. This program is shareware: you can try the program before you buy it.
  65. If you decide not to buy it, throw it away.
  66. Typically you obtain a copy of the program from a bulletin board or from a
  67. specialist shareware house.
  68. Your cost, if you decide not to buy, is limited to connect time charges or
  69. a few dollars for a shareware disk.
  70.  
  71. If you like the program, you must register your copy before you continue to
  72. use it.
  73.  
  74. The trial period for Crossword Publisher is three calendar days from receipt
  75. of your copy.
  76.  
  77. SOFTWARE LICENSE
  78.  
  79. Crossword Publisher is NOT public domain or free software.
  80.  
  81. You are not licensed to use this program after expiry of the trial period,
  82. three calendar days from receipt of your copy, unless you have registered your
  83. copy.
  84.  
  85. You are licensed to copy and distribute this program subject to the following
  86. conditions:
  87.  
  88. - Crossword Publisher may not be distributed in connection with, or as a part
  89. of, any other product or service.
  90.  
  91. - No fee of any kind may be charged for the copying and/or distribution
  92. thereof, excluding costs of duplication and distribution - not to exceed
  93. $10.00 per disk - without the express written permission of Longridge Software.
  94.  
  95. - The customer must be informed that any fee charged is solely to cover the
  96. cost of duplication.
  97. The customer is not buying the software, nor are they buying a license to use
  98. it.
  99.  
  100. - Distribution in modified form is not permitted.
  101. All files resident on this disk must be copied and distributed with the
  102. executable file, including this documentation.
  103.  
  104. - Crossword Publisher may not be "rented" to others.
  105.  
  106. - You agree to cease distribution when requested to do so by Longridge
  107. Software or by the author.
  108.  
  109. Operators of bulletin board systems are invited to post Crossword
  110. Publisher for downloading by all users, as long as the above conditions are met.
  111.  
  112. If you distribute Crossword Publisher please notify Longridge Software
  113. so that we can send you updates and new products directly.
  114.  
  115. Use of Crossword Publisher constitutes acceptance of the licensing provisions
  116. set forth herein.
  117.  
  118. SITE LICENSES AND QUANTITY PURCHASES
  119.  
  120. All individual, corporate, business, governmental, institutional or other users
  121. of Crossword Publisher must be registered.
  122.  
  123. Site licenses are available for any number of computers.
  124. Use of this software on multiple computers at the same commercial site is not
  125. permitted without a site license.
  126.  
  127. Write for liberal discount pricing on site licenses and / or multiple copy
  128. registration.
  129.  
  130. Longridge Software intends to prosecute any and all persons or institutions
  131. violating its copyright or the conditions set forth above.
  132. Write to Longridge Software for more information.
  133.  
  134. REGISTRATION
  135.  
  136. Please use the registration form provided on this disk when registering your
  137. copy of Crossword Publisher.
  138.  
  139. To register your copy of Crossword Publisher, send your name, street address
  140. (P.O. Box numbers are not acceptable), and the version number of the copy that
  141. you are registering to:
  142.  
  143. Longridge Software
  144. P. O. Box 771
  145. Naugatuck, CT 06770-0771
  146.  
  147. Enclose a check or money order for $45.
  148.  
  149. To find out about volume discounts and site licenses, write to the same
  150. address.
  151.  
  152. BENEFITS OF REGISTRATION
  153.  
  154. There are good reasons for registering your copy of this program.
  155.  
  156. In general:
  157.  
  158. - It's illegal to use the program and not register it.
  159. Using it once every year or so is still using it: you're making yourself
  160. liable for prosecution.
  161.  
  162. - Registration entitles you to technical support.
  163. A good company provides technical support for free, although you may have to
  164. pay for the cost of the phone call.
  165.  
  166. - Registered users are added to the publisher's mailing list, and receive
  167. notification of new product introductions, new version releases, workarounds
  168. for bugs, etc.
  169.  
  170. - Registered users often receive the latest version when the register.
  171. Sometimes this is an extra cost option.
  172. You will not need to be told how slowly new versions of software propagate
  173. through the shareware distribution network.
  174. Most of the software on your local bulletin board may be five or six years old.
  175.  
  176. - Nobody intends to have to recall a product, but recalls happen all the time.
  177. With a car, wheels fall off after 5,000 miles.
  178. With software, rarely used options wind up trashing your disk.
  179. Registered users can be contacted if a recall is necessary.
  180.  
  181. - Registration forms often contain surveys that provide the publisher with
  182. important market research data at no cost, allowing them to better address
  183. market needs without incurring expenses that increase the cost of the product
  184. to the registrant.
  185.  
  186. Specifically, for Crossword Publisher:
  187.  
  188. - Registration entitles you to complete details on how to use Crossword
  189. Publisher, limited updates, and technical assistance.
  190. You will be added to a mailing list and informed when new releases are made.
  191.  
  192. - The program is still under development, and new features are being added
  193. all the time.
  194. Registration brings you the latest version at the time of registration, and
  195. entitles you to reduced cost or free upgrades as new versions are released.
  196.  
  197. - Registered users will receive a manual that explains the program options
  198. in greater detail, and explains how to get the best out of the program.
  199.  
  200. - Registration is risk free: if for any reason you are not completely satisfied
  201. with Crossword Publisher, return your registration packet within 30 days and
  202. we will refund your license fee in full.
  203.  
  204. REQUIREMENTS
  205.  
  206. Crossword Publisher will work on any IBM PC, XT, AT or PS/2 compatible
  207. machine equipped with 128K of available memory (i.e. after MS-DOS and any TSRs
  208. have been loaded).
  209.  
  210. USING CROSSWORD PUBLISHER
  211.  
  212. To start the program type XWP and the name of a puzzle file, then press return.
  213. Two puzzle files are supplied with Crossword Publisher.
  214.  
  215. After composing your own crossword, you must create a puzzle file using a
  216. text editor or a database program.
  217. The format of the file is described later.
  218.  
  219. When you start Crossword Publisher, you must specify one or more switches to
  220. tell it what to do.
  221. Each of these switches may be abbreviated.
  222. Crossword Publisher will tell you if it is confused about what you mean.
  223.  
  224. /HELP causes Crossword Publisher to give you a summary of these switches.
  225.  
  226. /SOLVE causes Crossword Publisher to create a solved matrix: the cells will
  227. contain letters of the solution.
  228.  
  229. /LENGTHS causes Crossword Publisher to append solution length information to
  230. the clues: this gives the person solving the puzzle a useful hint.
  231. Solutions containing more than one word will have more than one number in the
  232. length data.
  233.  
  234. /MEMORANDUM causes Crossword Publisher to tell you what it intends to do before
  235. starting to read the puzzle data file.
  236.  
  237. /LOG causes Crossword Publisher to display the clues as it reads them in.
  238.  
  239. /SETUP=filename is used to specify which setup file (.XSU) Crossword Publisher
  240. will use.
  241. This defaults to XWP.XSU.
  242.  
  243. /CLUES=filename is used to specify the name of the file that Crossword Publisher
  244. will print clues to.
  245. The default name is the name of the puzzle data file, and the default extension
  246. is ".TXT".
  247.  
  248. /MATRIX=filename is used to specify the name of the file that Crossword Publisher
  249. will print the matrix to.
  250. The default name is the name of the puzzle, extended to eight characters with
  251. letters from "MATRIXWP".
  252. The default extension is ".TXT"
  253.  
  254. /EXPORT causes Crossword Publisher to translate the puzzle data file into
  255. two files suitable for use with Crossword Composer.
  256. You can use that program to alter your crossword, then convert the data files
  257. back to Crossword Publisher format with XWPCNV.
  258.  
  259. If you find yourself typing the same switches over and over, you should create
  260. a preference file, named XWP.PRF, which can contain any switch that could
  261. appear on the command line.
  262. You may have more than one preference file.
  263. Crossword Publisher will use the one it finds first, starting its search with
  264. the current directory, followed by the directory containing XWP.EXE (only works
  265. with MS-DOS 3.0 and later), followed by the environment variable XWP, followed
  266. by the directories on the MS-DOS path.
  267. A preference file is not required.
  268. Not finding one is not considered an error.
  269. We strongly recommend that you do not abbreviate switches in a preference
  270. file.
  271.  
  272. PUZZLE FILE FORMAT
  273.  
  274. A puzzle file normally has a file extension of ".XWP", and contains the
  275. definition of a crossword puzzle:
  276.  
  277. - The width and height of the crossword matrix in cells.
  278. These should be two decimal numbers on the same line, separated by a comma.
  279.  
  280. - The title and author of the crossword.
  281. These should be two strings delimited by double quoted, on the same line
  282. and separated by a comma.
  283.  
  284. - The clues and solutions making up the crossword, together with the direction,
  285. and row and column location.
  286.  
  287. Each clue and corresponding solution takes up one line of the puzzle file.
  288. Each line contains:
  289.  
  290. - The direction of the solution: word ACROSS or DOWN, followed by a comma.
  291.  
  292. - The solution, a double quote delimited string containing only letters and
  293. spaces, followed by a comma.
  294.  
  295. - The clue, a double quote delimited string, followed by a comma.
  296. If the clue is a tilde followed by the solution to another clue, then that
  297. clue is replaced by a same-as reference.
  298.  
  299. - The row location of the first cell of the solution in the matrix, a decimal
  300. number, followed by a comma.
  301. This may be any number from one up to and including the height of the matrix.
  302.  
  303. - The column location of the first cell of the solution in the matrix,
  304. a decimal number, followed by a comma.
  305. This may be any number from one up to and including the width of the matrix.
  306.  
  307. - A decimal number that will be replaced by the clue number.
  308.  
  309. USING XWPEDIT
  310.  
  311. The companion program XWPEDIT can be used to build and edit puzzle data files.
  312. To start XWPEDIT, just type XWPEDIT at the MS-DOS prompt.
  313. If you type the name of a puzzle file after XWPEDIT, the data file will be
  314. loaded into the editor.
  315.  
  316. The main menu will appear, showing the choices available to you.
  317.  
  318. USING CROSSWORD COMPOSER
  319.  
  320. PC-Help-Line distributes a program called Crossword Composer.
  321. Crossword Publisher can be used with this program.
  322. Use Crossword Composer to compose a puzzle if you find this more convenient
  323. than using XWPEDIT.
  324. Use XWPCNV to convert the Crossword Composer (CWC) data files to Crossword
  325. Publisher (XWP) format.
  326. You can export data files from Crossword Publisher in CWC format using the
  327. /EXPORT switch.
  328.  
  329. USING XWPCNV
  330.  
  331. This program has a number of switches in common with Crossword Publisher.
  332. The remainder are:
  333.  
  334. /[NO]AUTHOR: CWC format files do not contain a crossword author string,
  335. so XWPCNV allows you to specify one using the command line.
  336.  
  337. /BAR, /TILDE, /UNDERLINE: CWC format files use the tilde, underline and
  338. vertical bar as special characters.
  339. XWPCNV allows you to specify strings to replace these characters when the
  340. file is converted.
  341. If you specify more than one string for a character, the strings are used
  342. in rotation: the first string replaces the first instance of the character,
  343. the second string replaces the second instance, and so on.
  344.  
  345. LIMITATIONS
  346.  
  347. Crossword Publisher is designed to be used to convert a crossword puzzle into
  348. a text file that can be used by a desktop publishing program.
  349. It is not designed to be used to compose crosswords.
  350.  
  351. FEATURES
  352.  
  353. Crossword Publisher automatically numbers clues and solutions and checks
  354. word placement and validity of solutions.
  355.  
  356. The setup file allows almost limitless variations in the text produced by
  357. Crossword Publisher from the puzzle data file.
  358.  
  359. Setup files are provided that allow text files to be generated for use with
  360. Xerox Ventura Publisher, Professional Extension, and PostScript.
  361. A batch file is included to ease the task of creating an encapsulated
  362. PostScript file.
  363.  
  364. ABOUT LONGRIDGE SOFTWARE
  365.  
  366. Longridge Software is a shareware publisher.
  367. We distribute and support a number of software products written by third
  368. parties, providing our authors with a number of services, including centralized
  369. payment collection, business hour technical support, and publishing services.
  370.  
  371. Prospective authors are asked to write for our submission guide.
  372.  
  373. CONCLUSION
  374.  
  375. Thank you for trying Crossword Publisher, and for supporting the shareware
  376. concept.
  377. We hope that you will like the program and decide to keep it.
  378. Whether you decide to keep the program, or reject it because of some limitation
  379. or personal preference, we would like to hear your reactions.
  380. We regret that we cannot guarantee to reply to all correspondence, but we'll
  381. give it our best shot!
  382.  
  383. END OF XWP.DOC
  384.